Skip to main content
PATCH
Update advertiser budget.

Authorizations

Authorization
string
header
required

Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.

Path Parameters

advertiser_id
string<uuid>
required

Body

application/json

PATCH /manager/advertisers/{id}/budget — requires account_advertiser:budget permission.

budget
number
required

The budget to assign to the user.

Required range: x >= 0
credit
number
required

The credit to assign to the user.

Required range: x >= 0
expected_budget
number
required

The advertiser's budget from the loaded snapshot, used as an optimistic-lock token. Returns 409 if the stored budget no longer matches.

Required range: x >= 0
expected_credit
number
required

The advertiser's credit from the loaded snapshot, used as an optimistic-lock token. Returns 409 if the stored credit no longer matches.

Required range: x >= 0

Response

Successful Response

Response schema for User read operations.

created_at
string<date-time>
required
email
string
required

The user's email address

id
string<uuid>
required

The user's ID

is_active
boolean
required

Whether the user is active

role
enum<string>
required

The role of the user.

Available options:
advertiser,
operator,
admin
updated_at
string<date-time>
required
budget
number
default:0

The user's budget

credit
number
default:0

The user's credit

deleted_at
string<date-time> | null

Soft deletion timestamp for the user

name
string | null

The user's name

no
integer | null
permissions
UserPermission · object

The permissions of the user.

preferences
any | null

The user's preferences